// 版权归Go作者所有。版权所有。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// 此文件实现对RAT的编码/解码。

package big

import (
	"encoding/binary"
	"errors"
	"fmt"
)

// Gob编解码器版本。允许对编码进行向后兼容的更改。
const ratGobVersion byte = 1

// GobEncode实现gob.GobEncoder接口。
func (x *Rat) GobEncode() ([]byte, error) {
	if x == nil {
		return nil, nil
	}
	buf := make([]byte, 1+4+(len(x.a.abs)+len(x.b.abs))*_S) // 版本和符号位（1）和分子长度（4）的额外字节
	i := x.b.abs.bytes(buf)
	j := x.a.abs.bytes(buf[:i])
	n := i - j
	if int(uint32(n)) != n {
		// 这永远不会发生
		return nil, errors.New("Rat.GobEncode: numerator too large")
	}
	binary.BigEndian.PutUint32(buf[j-4:j], uint32(n))
	j -= 1 + 4
	b := ratGobVersion << 1 // 为符号位腾出空间
	if x.a.neg {
		b |= 1
	}
	buf[j] = b
	return buf[j:], nil
}

// GODECODE实现gob.GOBDCODECODE接口。
func (z *Rat) GobDecode(buf []byte) error {
	if len(buf) == 0 {
		// 另一方发送了一个零或默认值。
		*z = Rat{}
		return nil
	}
	b := buf[0]
	if b>>1 != ratGobVersion {
		return fmt.Errorf("Rat.GobDecode: encoding version %d not supported", b>>1)
	}
	const j = 1 + 4
	i := j + binary.BigEndian.Uint32(buf[j-4:j])
	z.a.neg = b&1 != 0
	z.a.abs = z.a.abs.setBytes(buf[j:i])
	z.b.abs = z.b.abs.setBytes(buf[i:])
	return nil
}

// MarshalText实现了encoding.TextMarshaler接口。
func (x *Rat) MarshalText() (text []byte, err error) {
	if x.IsInt() {
		return x.a.MarshalText()
	}
	return x.marshal(), nil
}

// UnmarshalText实现encoding.TextUnmarshaler接口。
func (z *Rat) UnmarshalText(text []byte) error {
	// TODO（gri）：摆脱[]字节/字符串转换
	if _, ok := z.SetString(string(text)); !ok {
		return fmt.Errorf("math/big: cannot unmarshal %q into a *big.Rat", text)
	}
	return nil
}
